home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 26 / AMIGAplus Sonderheft 26 (2000)(Falke)(DE)(Track 1 of 2)[!].iso / Tools / Packer / xfd / Docs / xfdDecrunchAddr.doc < prev    next >
Text File  |  1999-03-29  |  3KB  |  82 lines
  1. NAME
  2.     xfdDecrunch 1.3
  3.  
  4. SYNOPSIS
  5.     xfdDecrunchAddr SOURCE/A,DEST=TO,HEADER/N,ADDHEAD/S,DECRADDR,
  6.     JMPADDR
  7.  
  8. DESCRIPTION
  9.     xfdDecrunchAddr unpacks address crunched executablefiles. It
  10.     requires Kickstart V37+.
  11.  
  12.     When calling it "xfdDecrunchAddr ?" you get above synopsis.
  13.     Entering "?" here again brings you a deeper help.
  14.  
  15.     SOURCE specifies the file(s) that should be decrunched.
  16.     Wildcards are not supported.
  17.  
  18.     DEST is the file to save the result to.
  19.     Without DEST, the old file will be overwritten.
  20.  
  21.     HEADER specifies the header type, which should be linked to
  22.     the decrunched file:
  23.     0 - No header is linked.
  24.     1 - Only the executable hunk information is linked. This is useful
  25.         when the executable program is completely relocatable and thus
  26.         needs not to be forced to a certain memory region.
  27.     2 - Only the executable hunk information is linked, but this
  28.         contains one additional BSS hunk.
  29.     3 - The xfdDecrunch 1.08 simple header is linked.
  30.     4 - The xfdDecrunch 1.08 professional header is linked.
  31.     11- This is like 1, but the header overwrites file start and end.
  32.     12- This is like 2, but the header overwrites file start and end.
  33.     13- This is like 12, but has an additional empty RELOC hunk.
  34.     
  35.     Header types 1 and 2 are useful, when the decrunched file is again
  36.     crunched with another cruncher. The other headers would hide this
  37.     and xfd cannot recognize the file. Be careful when using this
  38.     header, as created files will crash, when using absolute addresses.
  39.  
  40.     Header types 11 to 13 are useful, when a file is double time
  41.     address crunched and the inner file-structure is overwritten by
  42.     NOP's or other commands. Be sure you know what you do when using
  43.     these headers!
  44.  
  45.     xfdDecrunchAddr automatically checks if destination is normal
  46.     executable (should not happen ever - only when someone forgot to
  47.     unhunk the file before crunching) or if it is double crunched
  48.     by testing header type 1 and 2 internally. A message appears in
  49.     case xfdDecrunchAddr got such an file.
  50.     You should save the file with the header type printed there and
  51.     start xfdDecrunchAddr again. When header type 0 is told it maybe
  52.     needed to use types 11 to 13.
  53.  
  54.     A special XFD external is supplied in LIBS:xfd/, which recognizes
  55.     xfdDecrunch and Object Master link headers and removes them. You
  56.     can use it to change the header type of decrunched file.
  57.  
  58.     ADDHEAD forces xfdDecrunchAddr to do nothing except adding one
  59.     of above headers. For headers 3 and 4 you need to specify DECRADDR
  60.     and JMPADDR. If no JMPADDR is given, xfdDecrunchAddr uses the
  61.     DECRADDR instead for JumpIn as well.
  62.  
  63. HISTORY
  64.     xfdDecrunchAddr 1.3
  65.     - added new headers
  66.  
  67.     xfdDecrunchAddr 1.2
  68.     - bug fix in help text
  69.  
  70.     xfdDecrunchAddr 1.1
  71.     - added ADDHEAD, DECRADDR and JMPADDR keywords and header addition
  72.  
  73.     xfdDecrunchAddr 1.0
  74.     - first version
  75.  
  76. COPYRIGHT
  77.     xfdDecrunchAddr is freely distributable and for
  78.     noncommercial use only.
  79.  
  80. AUTHOR
  81.     Dirk Stöcker <stoecker@amigaworld.com>
  82.